home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr10 / textc173.zip / TEXTCON.DOC < prev    next >
Text File  |  1993-06-01  |  69KB  |  1,348 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.        TextCon 1.73 Payment Form
  8.        --------------------------
  9.  
  10.        Payment of  $25 or  more for TextCon entitles you to a printed manual,
  11.        the current release of TextCon without the on-screen payment reminder,
  12.        and a  free CompuServe IntroPak, including a $15 credit toward on-line
  13.        time.   Payment of  $35 or more entitles you to a copy of TextDCA, the
  14.        enhanced version of TextCon.
  15.  
  16.          Name ____________________________________________________________
  17.  
  18.          Company _________________________________________________________
  19.  
  20.          Address _________________________________________________________
  21.  
  22.          City ________________________________ State ______ Zip __________
  23.  
  24.                                          Country _________________________
  25.  
  26.        ORDERING INFORMATION:
  27.  
  28.               Number of  Disk
  29.                Copies    Size    Price Per Copy              Total
  30.  
  31.        TextCon ______   _______   __________($25 suggested) ________
  32.  
  33.        TextDCA ______   _______   ___$35____                ________
  34.        Michigan residents, add 4% sales tax                 ________
  35.        Add $5 overseas shipping charge, if applicable       ________
  36.        Add $5 purchase order processing fee, if applicable  ________
  37.               (see "Bill company" below)
  38.                                              TOTAL PAYMENT  ________
  39.  
  40.        PAYMENT METHOD:
  41.  
  42.        ___  Check enclosed (US Funds):
  43.  
  44.        ___ Bill company (for purchase orders under $50 add $5 processing fee)
  45.  
  46.        ___ VISA / MasterCard #______________________________ Expires_________
  47.  
  48.            Signature ____________________________________________________
  49.  
  50.        Call (517) 332-4353 to pay by MasterCard or VISA, or send your payment
  51.        or purchase order to:   CrossCourt Systems
  52.                                1521 Greenview Ave.
  53.                                East Lansing, MI  48823
  54.  
  55.        Prices are in U.S. dollars and include shipping within North America.
  56.  
  57.        Foreign orders:   payment  must be by credit card, international money
  58.        order in  U.S. dollars,  or by  check in  U.S. dollars drawn on a U.S.
  59.        bank.  Payment must also include $5 shipping for airmail delivery.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                     TextCon 1.73
  67.                               the ASCII File Converter
  68.                            Another Shareware Product from
  69.                                  CrossCourt Systems
  70.  
  71.                    Member, Association of Shareware Professionals
  72.  
  73.  
  74.  
  75.                                  TABLE OF CONTENTS
  76.  
  77.           PURPOSE.................................................1
  78.  
  79.           TextDCA.................................................1
  80.  
  81.           FUNCTIONS...............................................2
  82.  
  83.           FILE FORMATS............................................3
  84.  
  85.           USE.....................................................4
  86.  
  87.           GENERAL CONVERSION PROBLEMS.............................5
  88.  
  89.           OPTIONS.................................................6
  90.  
  91.               BASIC OPTIONS.......................................7
  92.                   /W       sloppy Wordstar input..................7
  93.                   /R       soft Returns in output file............8
  94.                   /S#      Split long lines.......................8
  95.                   /K       Keep selected elements.................9
  96.  
  97.               LITTLE-USED, SPECIAL-PURPOSE OPTIONS...............11
  98.                   /T#      replace Tabs with spaces..............11
  99.                   /1, /2   line spacing of input file............12
  100.                   /E       drop End-of-sentence spaces...........13
  101.                   /P#      Paragraph spacing in output file......13
  102.                   /B       Block-style input file................13
  103.                   /I#      first-line Indent in output file......14
  104.                   /X, /Y   line-ending hYphen processing.........14
  105.  
  106.               EXPERT OPTIONS.....................................14
  107.                   /L#      cutoff Length.........................14
  108.                   /H#, /F# remove Headers or Footers.............15
  109.                   /Z#      end-of-paragraph marker in input file.16
  110.  
  111.           OTHER USES FOR TextCon.................................16
  112.  
  113.           REVISION HISTORY.......................................18
  114.  
  115.           DISTRIBUTION AND SUPPORT...............................20
  116.  
  117.           OTHER PRODUCTS FROM CROSSCOURT SYSTEMS.................21
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.        PURPOSE:
  125.  
  126.  
  127.        Virtually all  word processors  can import ASCII files, but anyone who
  128.        has tried  it knows  that the  results are  often less  than  optimal.
  129.        Imported ASCII  files almost  always require  a great  deal of  manual
  130.        "cleaning up"   to  get them into the desired format.  The most common
  131.        problems include  unwanted hard  carriage returns, extra blank spaces,
  132.        and extra blank lines.
  133.  
  134.        TextCon is  a file pre-processor for MSDOS computers that does most of
  135.        this cleaning  up for  you, before  you import  the file  to your word
  136.        processor.   The ASCII  files that  it produces  are in a form that is
  137.        much more  suitable for  importation to most word processors.  TextCon
  138.        does not  eliminate all  manual editing,  but it  makes the  job  much
  139.        easier.
  140.  
  141.        TextCon has  tremendous power  and flexibility that can also be useful
  142.        for other  tasks involving  data base  files, desktop  publishing, and
  143.        program editing.   TextCon  users have  found the  program helpful for
  144.        many  kinds   of  file   manipulations,  such   as   WordStar-to-ASCII
  145.        conversion, adding line feeds where only carriage returns are present,
  146.        expanding tabs to spaces, removing all blank lines from a file, etc.
  147.  
  148.        The program  is written in C, using the DeSmet C compiler, and runs on
  149.        most MSDOS machines.
  150.  
  151.  
  152.  
  153.        TextDCA:
  154.  
  155.  
  156.        Also available  from CrossCourt  Systems is TextDCA, which has all the
  157.        features of  TextCon, but  can also write files in IBM DCA/RFT format.
  158.        If you  have a  formatted  ASCII  file,  TextDCA  will  preserve  such
  159.        characteristics as  indents, centering,  and tabs in the DCA/RFT file.
  160.        This file  can then be imported to any word processor that will accept
  161.        "revisable-form-text", or  DCA/RFT, files.  This includes WordPerfect,
  162.        Microsoft  Word,   IBM  DisplayWrite,  MultiMate,  PC-Write,  XyWrite,
  163.        Volkswriter 3,  WordStar 2000,  and many other popular word processors
  164.        for the  IBM PC.   The  new document will contain the correct codes to
  165.        recreate the formatting of the ASCII file.
  166.  
  167.        As helpful  as this  is in  certain cases, there may be times when the
  168.        additional formatting  preserved by  using  this  transfer  method  is
  169.        undesirable.   If you  want the  final document to look different than
  170.        the ASCII  file, you  may find that the presence of the old formatting
  171.        codes hinders  your reformatting.   In  this case,  you will find that
  172.        TextDCA's (or TextCon's) standard ASCII conversion will perform all of
  173.        the cleaning you need.
  174.  
  175.        Because it  offers you  this choice of translation methods, TextDCA is
  176.        simply the  best program available for importing formatted ASCII files
  177.  
  178.  
  179.  
  180.        TextCon File Converter                                               2
  181.  
  182.  
  183.        to a word processor.  TextDCA also includes a menu-driven mode (on PC-
  184.        compatibles  only)   which  simplifies  the  selection  of  processing
  185.        options.   TextDCA is  not shareware, but can be ordered directly from
  186.        CrossCourt Systems for $35.
  187.  
  188.  
  189.  
  190.        FUNCTIONS:
  191.  
  192.  
  193.        The functions performed by TextCon fall into five main categories:
  194.  
  195.        1.  Removing carriage returns
  196.  
  197.            The most  common problem  when importing  ASCII  files  into  word
  198.            processors is  that each line from the original file will end in a
  199.            "hard" carriage  return.   In most  cases these have to be removed
  200.            manually in  order to  get the  document formatted properly on the
  201.            new word  processor.   TextCon uses  a sophisticated  algorithm to
  202.            determine which sections of text constitute "paragraphs", and then
  203.            it removes  all carriage  returns except  those  at  the  ends  of
  204.            paragraphs.   (For this purpose, a paragraph is defined as a block
  205.            of text  where it  is desirable  for words to wrap to following or
  206.            previous lines when editing or formatting changes are made.)
  207.  
  208.            TextCon can  cope  with  almost  any  paragraph  format  including
  209.            difficult ones  like  fully  indented  (nested),  hanging  indent,
  210.            outline style,  etc.   It does  not depend  on double  spacing  or
  211.            first-line indentation,  although these  are recognized.   It will
  212.            handle print-formatted  files (i.e., those having a left margin of
  213.            blanks), as well as the totally unformatted files used as input to
  214.            formatters like NROFF (as long as they use "dot" commands).  It is
  215.            designed to  recognize header  lines, tables,  etc. and will avoid
  216.            reformatting them.
  217.  
  218.            (Of course,  document formats  vary widely,  and it  really  takes
  219.            human  intelligence   to  recognize  paragraph  breaks  with  100%
  220.            accuracy.   TextCon will  occasionally make  mistakes when dealing
  221.            with particularly tricky formats.)
  222.  
  223.        2.  Adding carriage returns
  224.  
  225.            TextCon will  also do  the opposite  process if  you wish,  adding
  226.            carriage returns  to files  that have  them only  at the  ends  of
  227.            paragraphs.    Or  it  can  deal  with  special  file  formats  by
  228.            substituting carriage  returns for  some other  special  character
  229.            that is used to represent a paragraph end.
  230.  
  231.        3.  Removing blanks
  232.  
  233.            An ASCII  file may  have extraneous  blanks that cause problems if
  234.            they are imported to a word processor.  There may be blanks at the
  235.            beginnings of  lines for  a left  margin or for indented or nested
  236.  
  237.  
  238.  
  239.        TextCon File Converter                                               3
  240.  
  241.  
  242.            text.   Files from  mainframes  often  have  lines  with  trailing
  243.            blanks.  There may be extra blanks within lines for justified text
  244.            or between  columns of  a table  (where tabs  are more desirable).
  245.            TextCon removes extraneous blanks and, where appropriate, replaces
  246.            them with tabs, thus saving manual editing time.
  247.  
  248.        4.  Removing extraneous lines
  249.  
  250.            Some ASCII  files have  extraneous lines that TextCon will remove.
  251.            Print-formatted files,  for  example,  sometimes  have  additional
  252.            lines inserted  solely for  underlining or boldface.  TextCon will
  253.            remove these  so you  don't have  to.   TextCon recognizes double-
  254.            spaced files  and converts  them to  single spacing.   Lines  that
  255.            consist  solely  of  "dot"  commands  (like  WordStar's  .PA)  are
  256.            converted to  blank lines.   You can also remove (or add) lines by
  257.            setting the  spacing between  paragraphs to any specific number of
  258.            blank lines you wish.
  259.  
  260.            Consecutive runs  of more than two blank lines are reduced to two,
  261.            which may  help with files that have been formatted for a printer.
  262.            TextCon also  tries to  recognize page  breaks and  eliminate  all
  263.            blank lines  between pages  if possible.   The  situation is  more
  264.            complicated if  the file contains headers or footers, but there is
  265.            an option which can, in certain cases, remove these as well.
  266.  
  267.        5.  Removing or converting characters
  268.  
  269.            TextCon translates all characters in WordStar files to their ASCII
  270.            equivalents.   It also  removes all  non-printing ASCII characters
  271.            (except tabs)  unless you  ask that  they be  kept.   It has three
  272.            optional methods  for dealing  with line-ending  hyphens.  TextCon
  273.            does not  alter or  remove the IBM extended ASCII characters, used
  274.            for math symbols, letters from foreign alphabets, etc.
  275.  
  276.  
  277.  
  278.        FILE FORMATS:
  279.  
  280.  
  281.        TextCon was  designed to  be as automatic as possible in its operation
  282.        so it  can be  used by  someone with  very little  knowledge about the
  283.        files being  converted.   Although it has many options for specialized
  284.        kinds of  conversions, it  will work  very well  on a  wide variety of
  285.        files without the use of any of the options.
  286.  
  287.        The options are described in a later section.  If TextCon doesn't seem
  288.        to work  quite as  you want  it to,  first read the section on GENERAL
  289.        CONVERSION PROBLEMS.   If  this doesn't help, you may want to read the
  290.        option descriptions.  They include more detailed information about the
  291.        kinds of changes TextCon makes to a file and how you can control these
  292.        changes.
  293.  
  294.  
  295.  
  296.        TextCon File Converter                                               4
  297.  
  298.  
  299.        TextCon is  useful for cleaning up text files before importing them to
  300.        many  microcomputer   word  processors,   including  Microsoft   Word,
  301.        WordPerfect, and  IBM DisplayWrite,  as well as some office automation
  302.        systems, such  as NBI.   If  a word  processor exhibits  problems with
  303.        "hard carriage  returns" when you import ASCII files, then the chances
  304.        are that TextCon will help.
  305.  
  306.        Some PC  word processors,  including Volkswriter,  MultiMate, and  PC-
  307.        Write, actually require the hard returns when importing an ASCII file,
  308.        and have trouble with files that do not include them.  TextCon can add
  309.        carriage returns  to files  so that  these word  processors can import
  310.        them successfully.   This  is not  necessary, of  course, if  you  use
  311.        TextDCA to create a DCA/RFT file for importation to these programs.
  312.  
  313.        TextCon is  designed primarily  to read  ASCII files, but it will also
  314.        accept WordStar  files, including those from version 4.0.  However, it
  315.        is not  optimized for  WordStar  files  to  the  extent  that  it  can
  316.        translate dot  commands or  imbedded codes  for underlining, boldface,
  317.        etc.   Both the  commands and  the codes  are simply  removed from the
  318.        file, and  you have  to manually add the appropriate formatting to the
  319.        new document.   (The /KC option will keep codes in the converted file,
  320.        and the /KD option will do the same thing for dot commands.)
  321.  
  322.        If you  are importing  formatted ASCII  files to a word processor that
  323.        will accept  DCA/RFT format files, TextDCA offers an even higher level
  324.        of performance than TextCon itself.
  325.  
  326.  
  327.  
  328.        USE:
  329.  
  330.  
  331.        To run the program, use the command form:
  332.            TEXTCON [options] infile outfile
  333.  
  334.        The "options"  designate specific  types of  processing that  you want
  335.        done, and  are chosen from the list in a later section of this manual.
  336.        If you  specify an  illegal option, such as /A or /?, the program will
  337.        display  the   legal  options.     Again,  TextCon  will  handle  most
  338.        conversions very well with no options, so you don't have to read about
  339.        all of the options in order to use the program.
  340.  
  341.        The first  filename is  the name  of the input file, the second is the
  342.        output file.   The  file names  can include wildcards, employed in the
  343.        same way as with the DOS COPY command.  If a file already exists under
  344.        the output  name, it  will be  replaced without warning.  If the input
  345.        and output  names are  the same,  TextCon will  not proceed  with  the
  346.        conversion.
  347.  
  348.        A typical command with no options would be as follows:
  349.            TEXTCON A:*.* C:\DOCS
  350.  
  351.  
  352.  
  353.        TextCon File Converter                                               5
  354.  
  355.  
  356.        The options  are identified  by a  preceding slash or hyphen as a flag
  357.        character, so a command with options might look as follows:
  358.            TEXTCON /T5 /B TEXT.DOC B:TEXT.ASC
  359.        Options can  appear anywhere in the command line, so the preceding and
  360.        following commands are equivalent:
  361.            TEXTCON TEXT.DOC /T5 B:TEXT.ASC /B
  362.  
  363.        Multiple options  can be concatenated, using a single slash or hyphen,
  364.        to appear as follows:
  365.            TEXTCON /T5B TEXT C:\DOCS\TEXT.OUT
  366.        You must be careful when concatenating options this way, especially if
  367.        you are  using options with numeric "names" or those with sub-options.
  368.        For example,  if you  wanted to use the options /T3 /2 /KC /B, and you
  369.        combined them  as /T32KCB,  this would  be interpreted  as /T32  /KCB,
  370.        which is  very different than you intended.  If, instead, you combined
  371.        them as  /2BT3KC, they  would be  interpreted correctly.   Also,  when
  372.        interpreting an  option that  allows  sub-options,  TextCon  considers
  373.        every character up to the next blank to be a sub-option, so any option
  374.        of this  type must  either stand  alone or  be concatenated  last.  If
  375.        there is any question in your mind about this, keep all of the options
  376.        separate on  the command line.  (The menu system in TextDCA simplifies
  377.        this quite a bit.)
  378.  
  379.        The input  file must be an ASCII file or a WordStar file; TextCon will
  380.        not work  on an  internal word  processor file.  Some word processors,
  381.        including PC-Write  and Volkswriter,  always keep  their text in ASCII
  382.        files.   For other word processors, such as MultiMate, WordPerfect, or
  383.        Microsoft Word,  you will  have to  create an  ASCII copy of your file
  384.        before TextCon  will work  with it.  If you try to convert an internal
  385.        file, you may not get an error message from TextCon, but when you load
  386.        the converted  file into  another word  processor,  it  will  probably
  387.        contain gibberish.
  388.  
  389.        The output  file will still be in ASCII form, and you must treat it as
  390.        such when  loading it  into  your  word  processor.    For  some  word
  391.        processors, such  as DisplayWrite  or  WordPerfect,  you  must  use  a
  392.        special command.   For others, such as Microsoft Word or WordStar, you
  393.        can load it as you would any other document file.
  394.  
  395.  
  396.  
  397.        GENERAL CONVERSION PROBLEMS:
  398.  
  399.  
  400.        Many of TextCon's decisions are based on its analysis of the beginning
  401.        of your input file.  It analyzes approximately four pages of text, but
  402.        this will  vary from file to file.  If your file has sections that are
  403.        very distinct  in formatting,  the parameters  that TextCon determines
  404.        from the  beginning of  your file  may not be accurate for the rest of
  405.        the file.   In  these  cases,  TextCon  will  perform  better  if  you
  406.        subdivide the input file and process each distinctly formatted section
  407.        separately.
  408.  
  409.  
  410.  
  411.        TextCon File Converter                                               6
  412.  
  413.  
  414.        TextCon will  insert an  extra space  following the hyphen in any word
  415.        that is  hyphenated at  the end  of a line.  For example, the word ex-
  416.        ample will  be converted to ex- ample.  You can find these and convert
  417.        them fairly  easily by  searching for  "- "  (a hyphen  followed by  a
  418.        blank).   It could have been designed to remove hyphens at the ends of
  419.        lines, but then it would also have removed required hyphens, as in ex-
  420.        president.   You may  want to  use the /X or /Y options to change this
  421.        behavior.
  422.  
  423.        When a  converted ASCII  file is  loaded into  the new word processor,
  424.        tables may  have their  columns too  close together  or too far apart.
  425.        This is  because TextCon  puts tab  characters into tables in an ASCII
  426.        file, but  it cannot  set the positions for the tab stops.  As soon as
  427.        you set  the tab  stops where  you want them, the columns will line up
  428.        correctly.   By contrast,  when TextDCA writes a DCA/RFT file, it also
  429.        preserves the  settings  of  the  tab  stops,  thus  saving  you  some
  430.        additional time.   If  you don't  want tab  characters substituted for
  431.        spaces, you can use the /KS or /T# options.
  432.  
  433.        Sometimes TextCon  will fail  to remove  the carriage returns within a
  434.        nested or  fully-indented paragraph.  A common reason for this is that
  435.        the person  who created  it started  each line with a tab, rather than
  436.        using an  indent command.   You  can get  around this by using the /T#
  437.        option with some suitable tab value (usually 5 is a good choice).
  438.  
  439.        This problem  will also  occur if  the paragraph  is indented  a large
  440.        amount from the right margin, making the lines shorter than the cutoff
  441.        length.   Correct this with the /L# option, using a numeric value that
  442.        is less  than the  shortest line.   Be  sure to  take into account the
  443.        document margin when calculating this number.
  444.  
  445.        In certain  cases, TextCon  will  drop  whole  lines  from  the  file.
  446.        Whenever it  drops lines,  it will  display a  message on  the  screen
  447.        warning you that this has happened.  This dropping of lines is usually
  448.        desirable, but,  if it  is not,  you can  simply  rerun  TextCon  with
  449.        different options  that will prevent it from happening.  There are two
  450.        possible causes for this:
  451.        1.  The /F and /H options, of course, are intended to cause TextCon to
  452.            drop  lines  --  those  identified  as  header  or  footer  lines.
  453.            Occasionally the  use of  these options may cause text lines to be
  454.            dropped because  they are  mistaken for  headers or footers.  This
  455.            can be corrected by simply not using these options.
  456.        2.  TextCon automatically  drops  lines  that  are  inserted  for  the
  457.            purpose of  overprinting a  previous line.   These are not usually
  458.            wanted in  a converted  document.  If you want to force TextCon to
  459.            keep overprinted lines, use the /KO option.
  460.  
  461.  
  462.  
  463.        TextCon File Converter                                               7
  464.  
  465.  
  466.        OPTIONS:
  467.  
  468.  
  469.        Before converting  a file,  TextCon analyzes  the initial  portion  to
  470.        determine certain overall characteristics of the document.  During the
  471.        conversion, the  program applies  a complex set of rules on a line-by-
  472.        line  and   character-by-character  basis   to   determine   localized
  473.        formatting information.   Because  of this,  the  optional  parameters
  474.        described here  are not  usually needed.   In  any  case,  you  should
  475.        certainly try  a few  conversions before  using any  of these options.
  476.        Unless you  notice problems  or are  simply curious about the options,
  477.        you can ignore the following section.
  478.  
  479.        The following  describes each  of the  conversion options available in
  480.        the program.   Note  that some of them are inter-related or similar in
  481.        function.   The descriptions  are organized  into three groups.  BASIC
  482.        OPTIONS describes  the options that are used most often.  LITTLE-USED,
  483.        SPECIAL-PURPOSE OPTIONS  covers some that are rarely needed, but which
  484.        can sometimes  result in  a better conversion.  The EXPERT OPTIONS are
  485.        very similar,  but they  generally require  somewhat more expertise to
  486.        use.
  487.  
  488.        The options  are shown  in upper case, but lower case is acceptable as
  489.        well.
  490.  
  491.  
  492.        BASIC OPTIONS
  493.  
  494.        1.  /W                                           sloppy Wordstar input
  495.  
  496.            When the  file  to  be  converted  is  a  WordStar  file,  TextCon
  497.            recognizes this  automatically and processes the file accordingly.
  498.            When doing  this, TextCon  assumes that  the writer  used WordStar
  499.            "correctly", taking advantage of all of its formatting abilities.
  500.  
  501.            Unfortunately, many  writers use  a word  processor as  if it were
  502.            simply a  correctable typewriter.   This  may include, among other
  503.            bad habits,  using the  space bar  to  align  text  or  to  "nest"
  504.            paragraphs.   TextCon will  not perform  very well on this type of
  505.            file, because  it is  neither a  straight ASCII  file nor  a  true
  506.            WordStar file.
  507.  
  508.            The /W  option tells  TextCon to  treat the input file as a "semi-
  509.            formatted" WordStar  file, thus correcting for these sloppy typing
  510.            habits.  If you don't know how to recognize a poorly done WordStar
  511.            file, try  the conversion  both with and without the /W option and
  512.            compare the  results.   Most users  have found that their WordStar
  513.            files convert better with the use of this option than without it.
  514.  
  515.            (For the  technically minded,  the  /W  option  tells  TextCon  to
  516.            convert all  soft spaces  and soft carriage returns to hard spaces
  517.            and hard  returns in order to determine the intended formatting of
  518.            the file.   TextCon then strips out any of the spaces and carriage
  519.  
  520.  
  521.  
  522.        TextCon File Converter                                               8
  523.  
  524.  
  525.            returns that  it determines  are not  needed.    The  most  common
  526.            undesired side-effect  of this  is that  TextCon will occasionally
  527.            make a wrong paragraphing decision.  This is most likely to happen
  528.            in a  file  with  complex  formatting,  such  as  frequent  margin
  529.            changes.)
  530.  
  531.  
  532.        2.  /R                                     soft Returns in output file
  533.  
  534.            When TextCon  determines that  a carriage return from the original
  535.            file is  not the  end of  a paragraph,  i.e. that  it is  a "soft"
  536.            return, it simply omits it from the converted file.  The /R option
  537.            causes TextCon to keep these non-paragraph-ending carriage returns
  538.            as WordStar-type  soft returns (ASCII 141 followed by ASCII 10) in
  539.            the converted file.
  540.  
  541.            This is  useful  for  importing  files  to  WordStar,  because  it
  542.            eliminates the  need  to  perform  a  reformat  (Ctrl-B)  on  each
  543.            paragraph to  make it  readable.   It is also useful for importing
  544.            text to  other programs,  such as  LePrint, which expect WordStar-
  545.            type files  containing soft returns.  If you use it when importing
  546.            to a  standard word  processor, such  as WordPerfect, the WordStar
  547.            soft returns will cause peculiar results.
  548.  
  549.  
  550.        3.  /S#                                               Split long lines
  551.  
  552.            The /S#  option is  useful if  you have  a text file with carriage
  553.            returns only  at the  ends of paragraphs and a word processor such
  554.            as PC-Write  which requires  carriage returns  at the  end of each
  555.            line.   It tells  TextCon to  split each paragraph into lines of a
  556.            particular length,  given by  the numeric parameter.  For example,
  557.            /S65 says  that the  output file  should contain  lines  that  are
  558.            approximately 65 characters long.
  559.  
  560.            When you  use this  option TextCon splits lines at the first space
  561.            following the  specified length.  This means that the lines in the
  562.            file will,  on average,  be half a word longer than the length you
  563.            specify, and  some of  them may  be as much as 10 or 15 characters
  564.            longer.
  565.  
  566.            This option  will only  work on  files that  have very long lines,
  567.            that is,  those  files  where  TextCon  would  normally  keep  all
  568.            existing carriage returns.  It will not, for example, allow you to
  569.            take a  file with  paragraphs made  up of  80 character  lines and
  570.            reformat those  into paragraphs of 60 character lines.  That would
  571.            require it  to remove  some carriage returns and add others, which
  572.            it cannot  currently do.  (This can, however, be accomplished with
  573.            two passes  of the  program.  The first pass would remove carriage
  574.            returns, writing an ASCII file with very long "lines".  The second
  575.            pass, with  the /S#  option,  would  then  split  these  lines  as
  576.            desired.)
  577.  
  578.  
  579.  
  580.        TextCon File Converter                                               9
  581.  
  582.  
  583.  
  584.        4.  /K<sub-options>                             Keep selected elements
  585.  
  586.            As mentioned  earlier, one  of TextCon's  major  functions  is  to
  587.            remove certain  unneeded elements  from your  file.  In some cases
  588.            you may  want some  of these  elements to  be kept;  the /K option
  589.            allows this.
  590.  
  591.            The /K option is a bit different from the other options in the way
  592.            it is  specified.   It has  several "sub-options"  represented  by
  593.            additional key letters, which must immediately follow the /K.  If,
  594.            for example,  you wanted  only the  S sub-option,  the full option
  595.            descriptor would  be /KS,  whereas if  you wanted  all of the sub-
  596.            options, you  would use  /KBCDMORS.   (You may  also use  the full
  597.            option more  than once on the command line, so /KB /KC /KD /KM /KO
  598.            /KR /KS would also invoke all of the sub-options.)
  599.  
  600.            The "Keep" sub-options are as follows:
  601.  
  602.            a.  R sub-option                                    (Keep) Returns
  603.  
  604.                The R  sub-option  of  Keep  instructs  TextCon  to  keep  all
  605.                carriage returns in the converted file.
  606.  
  607.                Some word  processors (including WordStar, Microsoft Word, and
  608.                the "generic  word processor  format" from WordPerfect) create
  609.                ASCII files  that do  not have carriage returns at the ends of
  610.                lines, but  only at  the ends  of paragraphs.    This  greatly
  611.                simplifies the  job that TextCon has to do.  TextCon will nor-
  612.                mally recognize  these files,  and display  the  message  "All
  613.                carriage returns will be preserved."  If it does not recognize
  614.                such a  file, the  usual symptom  is that  the converted  file
  615.                frequently has  what should  be separate  paragraphs  combined
  616.                into one  paragraph.   In this case you will need to use the R
  617.                sub-option of Keep.
  618.  
  619.                This is  needed very  rarely however.  The most common use for
  620.                this sub-option  is to  take advantage  of some  of  TextCon's
  621.                other features,  such as  tab insertion  or  double-to-single-
  622.                spacing conversion, without its carriage-return stripping.
  623.  
  624.                Note that the R sub-option does not affect blank lines.  These
  625.                are still  stripped from  the  file  according  to  the  rules
  626.                explained under  the B  sub-option.   If you  want to keep all
  627.                lines intact you must use both the R and B sub-options.
  628.  
  629.            b.  B sub-option                                (Keep) Blank lines
  630.  
  631.                The B  sub-option of  Keep instructs TextCon to keep all blank
  632.                lines (except  those within  double-spaced paragraphs)  in the
  633.                converted file.
  634.  
  635.  
  636.  
  637.        TextCon File Converter                                              10
  638.  
  639.  
  640.                Normally, if  TextCon encounters  more  than  two  consecutive
  641.                blank lines  (or four  in a double-spaced document) it removes
  642.                the "extra"  ones (in  either case,  leaving only  two in  the
  643.                converted document).
  644.  
  645.                It also  tries to  recognize print-image files, i.e. ones that
  646.                contain the  actual page  breaks in the form of multiple blank
  647.                lines or  form-feed characters  at the  end of  one  page  and
  648.                beginning of  the next.   If  it does  recognize this, it will
  649.                remove  the   page  break  entirely  and  will  reconstruct  a
  650.                paragraph broken  between the  pages.  When TextCon's analysis
  651.                detects this  type of  format, it  prints a message describing
  652.                the file as "page-formatted".
  653.  
  654.                The B  sub-option of Keep overrides this blank-line stripping,
  655.                so that all blank lines are kept in the file.
  656.  
  657.            c.  S sub-option                                     (Keep) Spaces
  658.  
  659.                The S  sub-option of Keep instructs TextCon to keep all spaces
  660.                within text lines in the converted file.
  661.  
  662.                In addition  to the  substitution of  tabs for multiple spaces
  663.                (described under  the  /T#  option  below),  TextCon  normally
  664.                replaces any  set of  two or  more spaces  with a single space
  665.                unless it  is at  the end  of a  sentence.   At the  end of  a
  666.                sentence, it  replaces three  or more  spaces with  two.  This
  667.                helps with  files that  have had  spaces added  to justify the
  668.                right margin.  TextCon also removes any left margin spaces and
  669.                all trailing spaces from each line it processes.
  670.  
  671.                In some special cases this processing may be undesirable.  The
  672.                S sub-option  of Keep  overrides both the substitution of tabs
  673.                for multiple  spaces and  the deletion  of spaces, so that all
  674.                spaces within  a text  line (excluding  the  left  margin  and
  675.                trailing spaces)  are kept as found in the original file.  See
  676.                also the Keep Margin sub-option below.
  677.  
  678.            d.  M sub-option                              (Keep) Margin spaces
  679.  
  680.                The M sub-option of Keep instructs TextCon to keep spaces that
  681.                form a left margin in the converted file.  See the Keep Spaces
  682.                option just above for more on spaces.
  683.  
  684.            e.  C sub-option                              (Keep) Control codes
  685.  
  686.                TextCon normally  strips all  control codes  (ASCII characters
  687.                between 1  and 31), with the exception of tab characters.  The
  688.                C sub-option  of Keep  forces TextCon  to keep  control codes,
  689.                with the exception of form feeds (see the /KF option).
  690.  
  691.  
  692.  
  693.        TextCon File Converter                                              11
  694.  
  695.  
  696.            f.  F sub-option                                 (Keep) Form feeds
  697.  
  698.                The F sub-option of Keep forces TextCon to keep all form feeds
  699.                (ASCII 12)  in the  converted file, where most word processors
  700.                will interpret them as page breaks.
  701.  
  702.            g.  D sub-option                               (Keep) Dot commands
  703.  
  704.                The D  sub-option of  Keep forces  TextCon  to  keep  all  dot
  705.                commands in the converted file.
  706.  
  707.                Many word  processors use  "dot commands" to control the print
  708.                format of  a document.   TextCon normally removes dot commands
  709.                from each  file it  processes.   The D sub-option of Keep will
  710.                cause it to leave those commands in the file.
  711.  
  712.                TextCon is  fairly conservative  about removing  dot  commands
  713.                anyway, so  that it  won't accidentally  remove lines of text.
  714.                The only  lines that  will be  removed are  those that  have a
  715.                period in  column 1 and a letter in column 2, and don't extend
  716.                beyond column 12.  As a result, you may find that it sometimes
  717.                leaves dot commands in the converted file.
  718.  
  719.            h.  O sub-option                            (Keep) Overprint lines
  720.  
  721.                The  O   sub-option  of   Keep  forces  TextCon  to  keep  all
  722.                overprinted lines in the file.
  723.  
  724.                TextCon normally  removes all  overprinted lines.  Overprinted
  725.                lines often  occur in "print" files, as a method of performing
  726.                underlining or  boldface by printing over the same line twice.
  727.                In a file that contains carriage-return/line-feed pairs at the
  728.                ends of  lines (the  normal ASCII  format), TextCon recognizes
  729.                overprinted lines  as those  that end  with  only  a  carriage
  730.                return.  When a line like this is found, the following line is
  731.                removed and  a  warning  message  is  displayed.    With  some
  732.                unusual, non-standard  input file formats, this can cause loss
  733.                of text  in the conversion process.  If this should happen, or
  734.                for some  other reason you want to keep overprinted lines, use
  735.                the O  sub-option.  (Note that this uses the letter O, not the
  736.                numeral 0.)
  737.  
  738.  
  739.        LITTLE-USED, SPECIAL-PURPOSE OPTIONS
  740.  
  741.        1.  /T#                                       replace Tabs with spaces
  742.  
  743.            TextCon was  designed primarily  for importing  files to  the more
  744.            sophisticated word  processors, where  documents are often printed
  745.            with proportional  spacing.   For this kind of work, tabs are used
  746.            extensively to  position items in a document; multiple spaces will
  747.            not work  correctly.   For this  reason,  TextCon  preserves  tabs
  748.  
  749.  
  750.  
  751.        TextCon File Converter                                              12
  752.  
  753.  
  754.            rather than  expanding them  with blanks, unless the /T# option is
  755.            used.
  756.  
  757.            The /T#  option requires  a numeric  value  (e.g.,  /T4  or  /T0),
  758.            specifying the  number of spaces between tab stops.  The first tab
  759.            stop is  always at column one.  When a tab is found, enough spaces
  760.            are substituted  in the  converted file  to position the following
  761.            character at  the next  tab stop.  The default, of course, (if the
  762.            /T# option  is not  specified at  all) is that tabs are preserved,
  763.            whereas a value of zero (/T0) means they are removed entirely.
  764.  
  765.            If  the   /T#  option   is  used,  TextCon's  normal  behavior  of
  766.            substituting tabs  for multiple  spaces is  turned off also.  This
  767.            substitution is  normally done  in  three  circumstances:  at  the
  768.            beginning of  a paragraph  whose first  line is  indented; between
  769.            items in  a columnar table; and between a list-identifying number,
  770.            letter, or  symbol and  the corresponding list entry (for example,
  771.            the item "1.    /T#" above).
  772.  
  773.            This means that if you have a file that does not contain tabs, and
  774.            you simply  want to  suppress TextCon's  substitution of  tabs for
  775.            spaces, you  can use /T with any numeric value to accomplish this.
  776.            (The number  you use  doesn't really matter here, since it is used
  777.            only to determine the number of spaces to substitute when a tab is
  778.            found in the original file.)  The result of using this option will
  779.            differ slightly  from the  use of  the /KS  option, because the /T
  780.            option has  no effect  on TextCon's removal of excess spaces, such
  781.            as those used for justification.
  782.  
  783.  
  784.        2.  /1, /2                                  line spacing of input file
  785.  
  786.            TextCon is  designed to  recognize the  line  spacing  (single  or
  787.            double) used  in a  file, but  in some  rare cases  it will make a
  788.            mistake.   This will  often happen  when the  initial part  of the
  789.            document (the  part that  TextCon  analyzes  before  starting  the
  790.            conversion) has  different spacing  than the  rest.   When TextCon
  791.            finishes its analysis of a file, it displays on the screen what it
  792.            determined the  spacing to be.  If this is wrong, you will have to
  793.            use the  /1 or /2 option to specify that the input file is single-
  794.            or double-spaced.
  795.  
  796.            You can  also detect an improper spacing decision from problems in
  797.            the output  file.   The usual  symptom is  that the converted file
  798.            either will  contain many  hard carriage  returns and  be  double-
  799.            spaced, or will have many paragraphs run together.
  800.  
  801.            If TextCon's  double-space option is in effect, either through its
  802.            own decision  or because  you specified  it, single occurrences of
  803.            blank lines are totally ignored, as if they simply were not in the
  804.            file.   Two consecutive  blank lines  are treated as if there were
  805.            only a  single blank  line.   Occasionally you  may find that this
  806.            causes some  paragraphs to  run together  in the  converted  file.
  807.  
  808.  
  809.  
  810.        TextCon File Converter                                              13
  811.  
  812.  
  813.            This would  be most  likely to happen if single and double spacing
  814.            are mixed  in the  same document,  although normally  TextCon will
  815.            handle this correctly.
  816.  
  817.  
  818.        3.  /E                                     drop End-of-sentence spaces
  819.  
  820.            If TextCon  finds more  than one  space after  certain punctuation
  821.            marks, it  leaves exactly  two spaces, assuming it is the end of a
  822.            sentence.   The /E  option causes  it to  remove all extra end-of-
  823.            sentence spaces,  leaving only  a single  space.   This option  is
  824.            useful  for   documents  that  are  to  be  typeset,  because  the
  825.            typewriter-based  convention  of  separating  sentences  with  two
  826.            spaces is not needed for typeset material.
  827.  
  828.  
  829.        4.  /P#                               Paragraph spacing in output file
  830.  
  831.            TextCon normally  leaves paragraphs  spaced the  same way they are
  832.            spaced in  the original  file.   The usual style for single-spaced
  833.            documents has  one blank  line between  paragraphs;  double-spaced
  834.            documents usually  have no  extra blank  lines.   If your original
  835.            document has  one kind  of line  spacing and you want to print the
  836.            new document  with  different  spacing,  you  may  find  that  the
  837.            paragraph spacing is either too large or too small.
  838.  
  839.            The /P#  option tells  TextCon to  put a  specific number of blank
  840.            lines between  paragraphs in the converted document.  For example,
  841.            /P0 will  eliminate any  extra blank  lines between paragraphs, so
  842.            you might  use it  if your original file was single-spaced and you
  843.            wanted to  print the  new copy  double-spaced.   /P1 will end each
  844.            paragraph with exactly one blank line, so you might use it for the
  845.            opposite case.   (TextCon doesn't actually set the line spacing in
  846.            the converted document for you; you have to do that yourself after
  847.            you load it into the new word processor.)
  848.  
  849.            The /P#  parameter has  no effect  on paragraphs that consist of a
  850.            single line of text; those are assumed to be lists or tables whose
  851.            spacing should be preserved.
  852.  
  853.  
  854.        5.  /B                                          Block-style input file
  855.  
  856.            This option  tells TextCon  that your  file has  only  block-style
  857.            paragraphs, i.e.,  there are no paragraphs with first-line indents
  858.            or outdents.   TextCon  doesn't need  to know  this  in  order  to
  859.            process a  file, but there are some cases where it can do a better
  860.            job if it does.  This should be thought of as a little "tweak" for
  861.            those who want the absolute best performance.  If you use it for a
  862.            file that  contains non-blocked paragraphs, of course, performance
  863.            will be worse.
  864.  
  865.  
  866.  
  867.        TextCon File Converter                                              14
  868.  
  869.  
  870.        6.  /I#                               first-line Indent in output file
  871.  
  872.            As described  under the /T# option, TextCon normally substitutes a
  873.            tab character  for multiple  spaces at  the beginning  of indented
  874.            paragraphs.  The /I# option allows you to use a specific number of
  875.            spaces instead,  or to  convert indented paragraphs to block-style
  876.            paragraphs.
  877.  
  878.            This option  requires a  numeric value  indicating how many spaces
  879.            are to be used for indentation.  If, for example, you specify /I5,
  880.            all indented  paragraphs in  the converted file will have a first-
  881.            line indentation  of five spaces.  Using /I0 will convert indented
  882.            paragraphs to  block-style paragraphs (zero indentation).  The /I#
  883.            parameter has  no effect  at all  on paragraphs  that are  already
  884.            block-style or have hanging indents.
  885.  
  886.  
  887.        7.  /X, /Y                               line-ending hYphen processing
  888.  
  889.            As  described   under  GENERAL  CONVERSION  PROBLEMS,  line-ending
  890.            hyphens are normally preserved and a space is inserted after them,
  891.            so that you can find each one and make a decision as to whether it
  892.            needs to  be kept  in the  document.  If you already know that all
  893.            hyphens are  required hyphens  or that  all  of  them  are  "soft"
  894.            hyphens, you  can save  some editing  time by  using the  /X or /Y
  895.            options.
  896.  
  897.            The /X  option indicates that all line-ending hyphens are required
  898.            hyphens.   TextCon will leave them in the text and will not insert
  899.            a blank.   This  is useful  if you know that no "soft hyphenation"
  900.            has been performed on the file.
  901.  
  902.            The /Y  option indicates  that all  line-ending hyphens are "soft"
  903.            hyphens, and  that TextCon  should remove  them entirely.  This is
  904.            not a very useful option, because it would be a rare document that
  905.            you could safely assume had no line-ending required hyphens.
  906.  
  907.  
  908.        EXPERT OPTIONS
  909.  
  910.        1.  /L#                                                  cutoff Length
  911.  
  912.            TextCon automatically  determines a "typical" line length for your
  913.            document and  from this  calculates a  "cutoff" length used in its
  914.            paragraph-determination algorithms.  If a line is shorter than the
  915.            cutoff length, TextCon assumes that the carriage return at the end
  916.            of that line was put there intentionally, and the program will not
  917.            delete it.
  918.  
  919.            Note that  no line  is ever  truncated as a result of the "cutoff"
  920.            length.   This value  is only  used as  an aid  in deciding  which
  921.            carriage returns should be kept and which should be removed.
  922.  
  923.  
  924.  
  925.        TextCon File Converter                                              15
  926.  
  927.  
  928.            You can  use the  /L# option  to override TextCon and specify your
  929.            own cutoff  length.   As you  make the  cutoff length longer, more
  930.            lines will be shorter than that length, and thus will retain their
  931.            carriage returns.
  932.  
  933.            Note that  the length  of a  line is  not measured  from the  very
  934.            beginning of  the line  (column 1),  nor is  it measured  from the
  935.            first non-blank  character on that particular line.  The length is
  936.            measured starting  at the  left margin  of the  document, which is
  937.            determined by  the leftmost  non-blank character found anywhere in
  938.            the document.   If,  for example,  the left margin of the document
  939.            were 10  characters (meaning  the leftmost  character in  any line
  940.            occurred in  position 11),  a line with 15 leading spaces followed
  941.            by 20  characters would  have a  length of  15+20-10 = 25.  If the
  942.            cutoff length  were 26  or more,  that would be considered a short
  943.            line.
  944.  
  945.  
  946.        2.  /H#, /F#                                 remove Headers or Footers
  947.  
  948.            These are  two of  the trickier  options in TextCon, and should be
  949.            used with caution.  Their purpose is to remove running headers and
  950.            footers  from   page-formatted  files,   so  they  don't  wind  up
  951.            intermingled with the text.  They have the potential to save a lot
  952.            of manual  editing time  on some  files, but  they can  mistakenly
  953.            remove text  lines instead.   Of  course, the original file is not
  954.            modified in  any case,  so if  it doesn't  work correctly  you can
  955.            rerun TextCon without these options.
  956.  
  957.            The numeric parameter used with these options is the number of the
  958.            line on  each page  that contains  the header  or footer.   If you
  959.            don't want to figure this out yourself, you can omit the number or
  960.            use a  value of  zero, and  TextCon will  try to  determine  which
  961.            line(s) contain  the header  and/or footer.   Thus, /H3 /F64 would
  962.            ask TextCon  to remove  the third  and sixty-fourth  lines of each
  963.            page and  attempt to  join the text across page boundaries.  /F by
  964.            itself, on the other hand, would imply there was no running header
  965.            and that  TextCon should determine which line number appears to be
  966.            a footer.
  967.  
  968.            These options depend on a number of assumptions:
  969.            ∙   that your document either has exactly 66 lines per page, or it
  970.                has less  than 66 lines per page and uses form feed characters
  971.                to go to a new page (Note that if a file has "overprint" lines
  972.                without linefeeds  for the purpose of underlining or boldface,
  973.                these will  be stripped,  and don't count towards the 66 lines
  974.                per page.),
  975.            ∙   that the header or footer is only one line long,
  976.            ∙   that the  header or  footer always appears on the same line of
  977.                every page, and,
  978.            ∙   if you  do not  specify the  line number(s),  a running header
  979.                and/or footer  must occur  within the  first four pages of the
  980.                file
  981.  
  982.  
  983.  
  984.        TextCon File Converter                                              16
  985.  
  986.  
  987.  
  988.            If a  file meets  these criteria,  TextCon will remove the desired
  989.            lines very  accurately, usually  even combining  paragraphs across
  990.            page  boundaries.     If   a  file  diverges  slightly  from  that
  991.            description, TextCon  may erroneously  delete text  lines from the
  992.            file.   The best  advice is  to examine  closely any file that has
  993.            been created using this option.
  994.  
  995.  
  996.        3.  /Z#                          end-of-paragraph marker in input file
  997.  
  998.            This is  a very specialized option that would not often be used on
  999.            standard document  files.  It allows you to specify an alternative
  1000.            character that marks the ends of "paragraphs" in your file.
  1001.  
  1002.            The character  is specified by means of its decimal ASCII code, so
  1003.            for example,  /Z14 would  look for  a Ctrl-N  to mark  the ends of
  1004.            paragraphs and  /Z35 would  look for the symbol #.  The only ASCII
  1005.            values not allowed are 0 and 255.
  1006.  
  1007.            When this option is used, TextCon will do two things differently:
  1008.            a.  treat all carriage returns as soft returns, removing them from
  1009.                the file (which means that it overrides the /KR option), and
  1010.            b.  treat all  occurrences of  the  specified  character  as  hard
  1011.                returns, removing  them  from  the  file  and  substituting  a
  1012.                carriage-return/line-feed pair.
  1013.  
  1014.            This option  can be  extremely useful  for certain  types of  file
  1015.            transfers, particularly those involving databases, certain desktop
  1016.            publishing  applications,  and  manipulations  of  bulletin  board
  1017.            message files
  1018.  
  1019.  
  1020.  
  1021.        OTHER USES FOR TextCon:
  1022.  
  1023.  
  1024.        TextCon users  have found  some ingenious  ways to  use the program --
  1025.        tasks for  which the program was not intended, but which it does quite
  1026.        well.  The following examples may suggest some additional ways TextCon
  1027.        can aid in your text processing work.
  1028.  
  1029.        1.  Use of the Keep Option
  1030.  
  1031.            TextCon's /K  option figures  prominently in most of these special
  1032.            uses.   If you use /K with all of its sub-options (/KBCDMORS), the
  1033.            output file  will be  identical to  the input  file,  with  a  few
  1034.            exceptions.   This would  seem to  be a  pointless  thing  to  do,
  1035.            unless, of  course, those  exceptions are  important to you.  They
  1036.            are as follows:
  1037.            a.  If the  input file  has lines  that end  with only  a carriage
  1038.                return, TextCon will add a line feed to each of them.  You may
  1039.                occasionally get  files of this type, from certain programs or
  1040.  
  1041.  
  1042.  
  1043.        TextCon File Converter                                              17
  1044.  
  1045.  
  1046.                from  other  computers,  and  you  may  find  that  your  word
  1047.                processor will not accept them without the line feeds.
  1048.            b.  TextCon deletes trailing blanks from each line.
  1049.            c.  WordStar files are always converted to ASCII.
  1050.  
  1051.            Each of  these conversions  can be  extremely useful  for  certain
  1052.            kinds of  files, even  when you  don't  need  the  carriage-return
  1053.            stripping that is TextCon's main purpose.
  1054.  
  1055.  
  1056.        2.  Adding Carriage Returns
  1057.  
  1058.            You may  sometimes get  files from  another computer where a line-
  1059.            feed character, rather than a carriage return, is used to mark the
  1060.            ends of  lines.   This causes  great  difficulty  for  some  PCDOS
  1061.            software.
  1062.  
  1063.            TextCon can  convert these  files by  use of  the /Z# option.  The
  1064.            decimal ASCII  code for  line feed is 10, so the full option would
  1065.            be /Z10.   You  may  also  want  to  use  /KBCDMS  to  keep  other
  1066.            characteristics of  the file intact.  The /Z# option overrides the
  1067.            /KR option.
  1068.  
  1069.  
  1070.        3.  Removing Blank Lines
  1071.  
  1072.            TextCon removes  multiple blank lines by default, but leaves up to
  1073.            two blank  lines separating paragraphs.  If you want to remove all
  1074.            blank lines  from a  file, use  the /P0  option.  One TextCon user
  1075.            needed a  count of  only the non-blank lines in an ASCII file, but
  1076.            couldn't find  a counting  program that  would  do  that.    Using
  1077.            TextCon with  /P0 and  /KR produced  a file  with all of the blank
  1078.            lines removed.
  1079.  
  1080.  
  1081.        4.  Tab Expansion
  1082.  
  1083.            For  certain   programs  and   certain  applications   it  may  be
  1084.            inconvenient to  have tabs in a file.  TextCon can remove them and
  1085.            expand them  to spaces  via the /T# option.  If you use this along
  1086.            with  the  /KBCDMORS  option,  the  output  file  will  be  nearly
  1087.            identical to the input file, but with tabs expanded to spaces.
  1088.  
  1089.            This option  can also  be useful when dealing with badly formatted
  1090.            files.   Some people create fully indented paragraphs by inserting
  1091.            a tab  at the beginning of every line of the paragraph rather than
  1092.            by using  their word  processor's indent function.  This creates a
  1093.            mess if  you have to edit those paragraphs or move them to another
  1094.            word processor.   TextCon will interpret them as individual lines,
  1095.            not as  paragraphs.   However, if  you use the /T# option, TextCon
  1096.            will correctly recognize them as fully indented paragraphs.
  1097.  
  1098.  
  1099.  
  1100.        TextCon File Converter                                              18
  1101.  
  1102.  
  1103.        5.  Converting WordStar Files to Formatted ASCII Files
  1104.  
  1105.            TextCon can also be used as a general WordStar-to-ASCII converter.
  1106.            For this  purpose, you  should use  the /W and /KBMRS options.  If
  1107.            you want to keep some other characteristics, you might want to use
  1108.            the C, D, and O sub-options of Keep as well.
  1109.  
  1110.  
  1111.        6.  Formatting Files for LePrint
  1112.  
  1113.            LeBaugh Software's  LePrint program,  for printing in high-quality
  1114.            fonts on  dot-matrix printers, was designed primarily for use with
  1115.            WordStar files.   It  will accept  ASCII files, but it is somewhat
  1116.            more difficult  to use  this way.   The  main way  that  LePrint's
  1117.            preferred input  format differs  from standard  ASCII is that soft
  1118.            carriage returns  should be  indicated by  the characters WordStar
  1119.            uses for that purpose.
  1120.  
  1121.            TextCon can  create a  file for  LePrint if you use the options /R
  1122.            /KBCDMS.
  1123.  
  1124.  
  1125.  
  1126.        REVISION HISTORY:
  1127.  
  1128.  
  1129.            TextCon 1.1
  1130.  
  1131.            This was the first version to be distributed as shareware.
  1132.  
  1133.  
  1134.            TextCon 1.2
  1135.  
  1136.            1.  Renamed the former /L option to /B.  Changed the /T# option to
  1137.                use true  tab stops.  Added new /L# option, as well as /H, /Y,
  1138.                and /R.
  1139.            2.  Expanded the  file  analysis  stage  to  determine  additional
  1140.                document  characteristics,   including  typical  line  length,
  1141.                standard margin,  recognition of  unformatted, formatted,  and
  1142.                print-formatted files, and header and footer locations.
  1143.            3.  Additional   fine-tuning   of   parameters   and   algorithms,
  1144.                particularly in  regard to  hanging indents,  centered  lines,
  1145.                table-recognition, and list items.
  1146.  
  1147.  
  1148.            TextCon 1.3
  1149.  
  1150.            1.  Renamed many  options.   /B, /C, and /S became the B, R, and S
  1151.                sub-options of  the new  /K (for  Keep) option.   /R was split
  1152.                into the  /F# and /H# options, both of which now accept a line
  1153.                number as  a parameter.   /D became /2, and /H became /X.  The
  1154.                renaming may  cause confusion  for users of previous versions,
  1155.  
  1156.  
  1157.  
  1158.        TextCon File Converter                                              19
  1159.  
  1160.  
  1161.                but it  was required to accommodate new options.  Such a major
  1162.                change should not be necessary again.
  1163.            2.  Dropped one  option.   /W was  no  longer  needed  because  of
  1164.                improvement in  recognition of  WordStar files.   However, see
  1165.                the new /W option below.
  1166.            3.  Added new  options.   /1 option  specifies single spacing.  /B
  1167.                specifies that  all paragraphs are block style.  /M# specifies
  1168.                the minimum  size of  the left  margin of  the document.    /W
  1169.                option specifies  different processing of WordStar files.  /Z#
  1170.                specifies that  the original  file has  a particular character
  1171.                that always  marks paragraph  ends.  /S# will split files with
  1172.                long lines  into shorter  lines.   The C  sub-option of the /K
  1173.                option specifies  that control codes are to be kept in the new
  1174.                file.
  1175.            4.  Automatic removal  of lines  that are  added  only  for  print
  1176.                emphasis.  In a file whose lines end in CR-LF pairs, these are
  1177.                easily recognized  because they are preceded by a line without
  1178.                a line feed.
  1179.            5.  Additional improvement  of decision  rules  and  general  fine
  1180.                tuning for better paragraph recognition.
  1181.  
  1182.  
  1183.            TextCon 1.4
  1184.  
  1185.            1.  Added the  /R option  as well  as the  D and  O sub-options of
  1186.                Keep.
  1187.            2.  Yet more  fine tuning  of the algorithms used, especially with
  1188.                regard to tables and tab insertion.
  1189.            3.  More complete  processing of WordStar files, including version
  1190.                4.0.
  1191.  
  1192.  
  1193.            TextCon 1.5
  1194.  
  1195.            1.  Optimized the program so that it now runs almost twice as fast
  1196.                as earlier versions.
  1197.  
  1198.  
  1199.            TextCon 1.6
  1200.  
  1201.            1.  Eliminated the  /M option; improvements in the program made it
  1202.                no longer necessary.
  1203.            2.  Program now  allows the use of the slash as well as the hyphen
  1204.                to denote options on the command line.
  1205.            3.  Rewrote  the  documentation  to  better  explain  some  common
  1206.                questions about the options.
  1207.            4.  Combined some  of the  DCA/RFT options of TextDCA to make them
  1208.                easier to use.
  1209.  
  1210.  
  1211.  
  1212.        TextCon File Converter                                              20
  1213.  
  1214.  
  1215.            TextCon 1.7
  1216.  
  1217.            (NOTE:   If you  used an earlier version and have not sent payment
  1218.            for your use, please consider doing so now.)
  1219.  
  1220.            1.  Added full  support for  wildcard filenames, to speed up large
  1221.                conversions.
  1222.            2.  Added the  /E option  and the  M sub-option of Keep.  Modified
  1223.                the S option of Keep so it does not affect the margin.
  1224.  
  1225.  
  1226.            TextDCA 1.7
  1227.  
  1228.            TextDCA is  a separate program, available directly from CrossCourt
  1229.            Systems for $35..  TextDCA has two features not found in TextCon.
  1230.            1.  DCA/RFT output  format.   The /D option specifies that instead
  1231.                of an  ASCII file,  the output  should be  written in  DCA/RFT
  1232.                format.  Most of the major PC word processors now support this
  1233.                format, which,  unlike ASCII  files,  can  contain  formatting
  1234.                information such as margins, centering, tab settings, indents,
  1235.                etc.   Now TextDCA  can pass  all this  information on to your
  1236.                word processor, saving a tremendous amount of reformatting.
  1237.            2.  Menu mode.   TextDCA permits optional menu-driven selection of
  1238.                processing options, for those who have trouble with its normal
  1239.                command-line syntax.   The  menu system  works only on IBM-PC-
  1240.                compatibles, not  on MSDOS  machines such  as the Wang PC, DEC
  1241.                Rainbow, TI Professional, Tandy 2000, etc.
  1242.  
  1243.  
  1244.  
  1245.        DISTRIBUTION AND SUPPORT:
  1246.  
  1247.  
  1248.        TextCon is Copyright 1986, 1987, 1988, 1990, CrossCourt Systems.
  1249.  
  1250.        If you  try TextCon  and find  it to be a useful and valuable product,
  1251.        please complete  your purchase  of it by sending payment to CrossCourt
  1252.        Systems at  the address  below.   For $25  you will  receive a printed
  1253.        manual and  the current  version of the program, without the on-screen
  1254.        payment reminder.   TextDCA,  described earlier  in  this  manual,  is
  1255.        available for $35.
  1256.  
  1257.        With your  purchase, you  will also  receive a  free IntroPak  for the
  1258.        CompuServe Information  Service, the  premiere interactive  electronic
  1259.        communication service.   CompuServe  provides news,  financial  infor-
  1260.        mation, entertainment  services, personal  computing services, special
  1261.        interest forums,  and more.  The IntroPak includes $15 of free on-line
  1262.        time.
  1263.  
  1264.        VISA and  MasterCard are accepted.  Volume discounts and site licenses
  1265.        are also available.
  1266.  
  1267.  
  1268.  
  1269.        TextCon File Converter                                              21
  1270.  
  1271.  
  1272.        In the  spirit of shareware, we believe that the value of a program is
  1273.        best determined  by you,  based on the number of copies you are using,
  1274.        the frequency  of use,  and the  amount of  time it  saves you.    Our
  1275.        business policy  is to accept payments both above and below the stated
  1276.        $25 price for TextCon.
  1277.  
  1278.        TextCon may  be distributed  to others,  as long as: 1) the program is
  1279.        not altered  in  any  way,  2)  the  documentation  files  are  always
  1280.        included, and  3) no  charge is  made for  such distribution  beyond a
  1281.        modest disk  preparation fee.  For bulletin board distribution, please
  1282.        use the file name TEXTCON.ZIP or TEXTCN.ZIP
  1283.  
  1284.        TextCon has  been tested  and performs  its functions  essentially  as
  1285.        described above,  without causing any damage to the computer in use or
  1286.        any of  its files.   However, all users are responsible for backing up
  1287.        their own  files, and CrossCourt Systems assumes no responsibility for
  1288.        any damage or losses incurred as a result of its use.
  1289.  
  1290.        CrossCourt Systems  supports TextCon,  by providing  technical  assis-
  1291.        tance, bug fixes, and enhancements.  CrossCourt Systems can be reached
  1292.        on CompuServe  at 72446,2704,  or at  the address and phone below.  If
  1293.        you encounter  problems with  any conversion,  or have suggestions for
  1294.        improvements, please let us know about them.
  1295.  
  1296.        CrossCourt Systems
  1297.        1521 Greenview Ave.
  1298.        East Lansing, MI 48823
  1299.        (517) 332-4353
  1300.  
  1301.        CrossCourt Systems  is  a  member  of  the  Association  of  Shareware
  1302.        Professionals (ASP),  a group  dedicated  to  high  standards  in  the
  1303.        design, documentation,  and support  of shareware products.  ASP wants
  1304.        to make  sure that  the shareware principle works for you.  If you are
  1305.        unable to  resolve a shareware-related problem with an ASP member, the
  1306.        ASP Ombudsman  may be able to help.  Please write to the ASP Ombudsman
  1307.        at P.O.  Box 5786,  Bellevue, WA  98006 or  send a CompuServe EasyPlex
  1308.        message to ASP Ombudsman 70007,3536.
  1309.  
  1310.  
  1311.        OTHER PRODUCTS FROM CROSSCOURT SYSTEMS:
  1312.  
  1313.  
  1314.        TextOut/5 -  converts WordPerfect  5.0 or  5.1 files  to  ASCII,  with
  1315.        improvements over  WordPerfect's Text  Out command,  in both  the "DOS
  1316.        Text" and  "generic word  processing" formats.   It converts foot- and
  1317.        endnotes, text boxes, and equations, and formats tables better than WP
  1318.        does.   Allows wildcards  for fast  multiple conversions.    Shareware
  1319.        found as TXTOUT.ZIP or TEXTOUT5.ZIP on bulletin boards.  Available for
  1320.        $20 direct (includes printed manual).
  1321.  
  1322.        ConvDW -  converts IBM  DisplayWrite 3  or 4  files to ASCII, offering
  1323.        many of  the same  options as  TextOut/5, including the generic-format
  1324.        option that  DW lacks.   IBM  does not  publish the  file  format  for
  1325.  
  1326.  
  1327.  
  1328.        TextCon File Converter                                              22
  1329.  
  1330.  
  1331.        DisplayWrite, so  ConvDW is  one of only a handful of programs, either
  1332.        shareware or  commercial, that  can read  DisplayWrite files.  Usually
  1333.        found as  CONVDW.ZIP on  bulletin boards.   Available  for $20  direct
  1334.        (includes printed manual).
  1335.  
  1336.        DisplayWrite Conversion  Package -  includes a  report describing  the
  1337.        format of  DisplayWrite files,  as well as Microsoft C source code for
  1338.        ConvDW, DWtoRFT, and DumpDW.  Call for information.
  1339.  
  1340.        DWtoRFT -  converts  DisplayWrite  files  to  DCA/RFT  using  wildcard
  1341.        filenames.   Great for  large conversions  from DisplayWrite  to other
  1342.        formats.  Available for $50 direct.
  1343.  
  1344.        ConvDCA - converts IBM DCA/RFT format files to ASCII, offering many of
  1345.        the same  options as  TextOut/5.    Usually  found  as  CNVDCA.ZIP  or
  1346.        CONVDCA.ZIP on bulletin boards.  Available for $20 direct.
  1347.  
  1348.